home *** CD-ROM | disk | FTP | other *** search
-
- DiskList V3.20 21.08.1992
- ==================
- by GSP '92
-
-
-
- 0. Das Übliche...
-
- DiskList V3.20 ist Public Domain, d.h. es darf in dem Ordner nur
- komplett kopiert und weitergegeben werden.
-
- WICHTIG: Für alle etwaigen (schönes Wort, gell!) Schäden, die durch
- die Benutzung von DiskList entstehen (könnten), kann ich keine
- Haftung übernehmen.
-
- ==> Jeder benutzt DiskList kostenlos + auf eigene Gefahr!
-
-
- Folgende Dateien sollten in einem Ordner namens DISKLIST sein:
- DISKLIST.PRG oder
- DISKLIST.APP oder
- DISKLIST.ACC das Hauptprogramm/Accessory
- DISKLIST.RSC das Resourcefile
- DISKLST3.DIR eine Beispiel-Library (nicht so wichtig)
- DISKLIST.TXT dieser Text (oho!)
- IMPORT.DOC ist ein Beispiel, wie die exportieren Daten
- in 1stMail importiert werden.
-
- ... wie gesagt: Das Übliche :-)
-
-
- Ich möchte an dieser Stelle noch unbedingt betonen, daß ich es
- fair finde, wenn man sich (für den Fall, man benutzt DiskList oft
- oder gerne), auch, im einem selbstzubestimmenden Rahmen, durchaus
- erkenntlich zeigt, indem man dann vielleicht doch mir einen
- (kleinen ??) Betrag zukommen lassen würde, oder zumindest 'ne
- (schöne?) Postkarte (von mir aus auch als UUE ;-) vom Heimatort
- (PostCardWare? !!!).
- Weil, so eigentlich, war das ja doch gar nicht sooo sehr wenig
- Arbeit, DiskList zu schreiben, und ich finde es ja manchmal auch
- gar nicht sooo sehr unpraktisch, wenn man mal 'ne Datei sucht,
- oder so, gell??
-
- Deshalb hier meine Adresse:
-
- Peter Seitz
- Robert-Koch-Str. 6
- 63225 Langen
-
- E-Mail (Internet): seitz@rbg.informatik.th-darmstadt.de
- [schreib' mal wieder!]
-
-
- + die Konto-Nummer:
- Sparkasse Langen-Seligenstadt
- BLZ 506 521 24
- Kto-Nr. 128 032 265
-
-
- Wenn schriftlichen Anfragen >= 1 Diskette + >= 1 frankierter
- Rückumschlag beiliegt, kann man sich (ziemlich) sicher sein, daß
- demnächst 'ne neue Version von DiskList auftaucht!
-
-
-
- Jetzt kommt aber endlich die Beschreibung:
-
-
- 1. Was kann DiskList ?
-
- DiskList dient dazu, die Inhaltsverzeichnisse von vielen Disketten
- einzulesen, um dann irgendwann einmal rauszukriegen, wo ein File
- denn nun steckt.
- Dazu werden Librarys (xxx.DIR) angelegt, welche die Informationen
- enthalten und die dann am besten auf der Harddisk gelagert werden,
- um so schnell zugreifen zu können.
- Außer Disketten können nartürlich soviele andere Laufwerke
- eingelesen werden, wie man bekommen kann, also auch Wechselplatten
- und so was, was sich halt alles über das GEMDOS ansprechen läßt.
-
- ***** NEU! *****
-
- In der Version 3.20 hat sich vieles getan:
-
- * Zu jeder Datei kann ein Kommentar gespeichert werden. Dieser
- kann zB aus Stichworten bestehen, die dann auch gesucht werden
- können.
-
- * Die Inhaltsverzeichnisse von Archiven (LZH, ZOO, ARC, ARJ)
- können eingelesen werden. Kommentare in den Archiven werden
- dabei übernommen.
- D.h. es kann auch nach Files in Archiven (Stichwort: Backup)
- gesucht werden!!
-
- * Die '.DIR' Files vom UNIXMODE-Standart werden mit eingelesen,
- is' vielleicht nicht ganz sooo wichtig...
-
- * Es gibt eine Schnitstelle zu Datenbanken: Die eingelesen
- Informationen können so beliebig wiederverwertet (äh,
- Recycling!? - eher weiterverwertet ;-) werden.
-
- * Das VA/AV-Protokoll von Gemini wird unterstützt: DiskList kann
- u.a. als ACC AV_OPENWIND versenden (halt so wie TreeView), als
- Applikation kann VA_DRAGACCWIND gesendet werden, es können also
- Dateien auf Fenster von anderen Accessories 'gedragged' werden.
- AV_OPENWIND kann auch empfangen werden.
-
- * Das XAcc2-Protokoll wird zT unterstützt: ALLE (!) Text-Fenster
- können versendet werden (natürlich nur der Text im Fenster...).
-
- * Das View-Protokoll wird unterstützt: Alle eingelesenen Files
- können, falls auf sie über das GEMDOS zugegriffen werden kann)
- an einen installierten File-Viewer (zB GEM-View, ShowImage)
- gesendet werden, um zu sehen, was nun wirklich drin steht.
-
- * WINX wird unterstützt (zB das BackDrop).
-
- Neu in Version 3.21 / 3.22 (neben vielen Kleinigkeiten):
-
- * ZIP-Archive werden jetzt (hoffentlich ;-) richtig eingelesen.
-
- * Es gibt ein Help-Popup in Datei-Fenstern, so daß man alle
- vorhandenen Funktionen auch per Maus auswählen kann.
-
- * Mag!X wird nun auch als Multi-Tasking-System erkannt
- + einige Funktionen auch ausgenutzt (intern).
-
- * Das XAcc2-Protokoll sollte nun auch auf Multi-Tasking-Systemen
- funktionieren (getestet wird, ob shel_write(7) oder appl_search()
- vorhanden ist.
-
- * In Text-Fenstern kann man nun auch suchen (nach Texten...)!
-
- * Optionen kann man nun abspeichern (wow!)
-
- Und noch einige Kleinigkeiten, die ich jetzt vergessen habe...
-
-
-
- 2. Bedienung!
-
- DiskList läuft als Accessory und (da das dann kein großen Aufwand
- mehr ist) auch als Applikation.
- Nach dem Start wird das Dialog-Fenster geöffnet, in dem alle
- Vorgänge per Maus ausgelöst werden können. Genausogut kann man
- auch alles mit der Tastatur machen.
-
- 2.1. Das Main-Window
-
- Kurze Erklärung der Buttons mit jeweiliger Taste:
-
- [Library] - hiermit wird die aktuelle Library ausgewäht, in die alle
- "L" Verzeichnisse eingelesen werden und in der gesucht werden
- kann. Die ausgewählte Library wird rechts daneben angezeigt.
- Wenn die Library gewechselt wird, sollten vorher alle Datei-
- Fenster geschlossen werden, da dies nicht automatisch
- geschieht.
- [Info] - Zeigt die Informationen des 'Library'-Fenster (s.u.)
- "I" Zusätzlich wird die Library auf Fehler/unbekannte
- Chunks untersucht + gemeldet, wenn was nicht in
- Ordnung ist.
- [Speichern] - Na ratet mal... Na? Die Library wird gespeichert!
- "S" (Sowas!)
- [Anzeigen] - Das 'Library'-Fenster wird geöffnet.
- "A" Das passiert aber auch, wenn die Library gewechselt
- wird oder wenn neue Disketten eingelesen werden.
-
- [Einlesen] - Das (daneben) eingesetellte Laufwerk wird
- "E" eingelesen. (s.u.)
-
- [Laufwerk] - Hier kann das Laufwerk zum Einlesen gewählt werden.
- Natürlich
- Cursor <- können auch nur wirklich vorhandene eingestellt werden;
- Cursor -> theoretisch bis zu 32 Stück - das konnte ich nur nicht testen.
- Die 'neuen' Laufwerke/Filesysteme unter MiNT
- klappen jedenfalls.
-
- [Hinzufügen] - Eine andere Library kann zur aktuellen hinzugefügt
- werden (deshalb heißt der Button so...)
-
- [Suchen] - Eine sehr elementare Funktion ist natürlich das Suchen.
- "S" Es kann eine Such-Maske eigegeben werden, nach der gesucht
- wird!!! (Kaum zu glauben!?) - Dafür ist DiskList ja doch da.
- Natürlich können Wildcards verwendet werden und zwar:
- '*' - Beliebig viele Zeichen (auch gar keins)
- '?' - genau ein Zeichen
- '[ac-e]' - Ein 'a' und alle Zeichen von a bis e, gemäß
- ASCII.
- '[^aq3]' - Alle NICHT angeführten Zeichen. (bei [^...])
- '\a' - Ein 'a'
- '\*' - Ein '*' (Damit man auch sowas suchen kann!)
- Dabei können beliebig viele (na halt so viele, wie in die
- Maske passen) Wildcards verwendet werden, auch ein '*' am
- Anfang oder in der Mitte ('*A*B?[Q-R]', wenn's sein muß).
- Zu beachten ist, daß '*' ALLE Dateien findet, '*.*' hingegen
- nur solche, welche auch eine Extension besitzen (z.B. nicht
- 'LIESMICH', aber 'LIESMICH.TXT'). Außerdem werden die
- eingegebenen Zeichen in Großbuchstaben gewandelt, da kleine
- ohnehin nicht sinnvoll sein dürften.
- Zusätzlich können ab Version 3.11 auch mehrere Masken ange-
- geben werden, mit ',' getrennt. Diese werden dann alle
- probiert.
- Die gefundenen Dateien werden mit Fundstelle (d.h.
- Diskette + Pfad) in einem neuen Dateien-Fenster
- angezeigt.
-
- In Version 3.20 hat sich noch einiges getan:
- Es kann nun auch nach Kommentar(-Teilen) und nach
- einem Datei-Datum-Bereich gesucht werden.
-
- [Optionen] - Damit bekommt man das Optionen-Dialog auf'n
- "O" Bildschirm. Der wird weiter unter beschrieben.
-
- [GSP] - Zeigt die Info-Meldung mit der Versionsnummer von DiskList an.
- "Help" So was muß ja dabei sein.
-
- [Quit] - Naja, ratet mal...
- Return, Esc
-
-
- Batchfile
- [Ausführen] - Dieser Button sollte disabled (grau) dargestellt sein, da das
- ("B") noch nicht geht.
- Falls es mal gehen wird, wird es aller Wahrscheinlichkeit nach
- folgendes machen:
- Es sollen Batchfiles erstellt werden können, welche Datei-
- namen, Ordner und sowas enthalten können. Diese werden dann
- daraufhin überprüft, ob sie in einer bestimmten Library
- vorkommen und so festgestellt, wann + wo die letzte Sicherung
- vorgenommen wurde. Somit können alle geänderten Dateien an ein
- geeignetes Kopierprogramm übergeben werden (z.B. KOBOLD),
- welches diese auf die Backup-Disketten sichert.
- ==> Also ein Backup-Utility.
- Dieser "Batch-Betrieb" soll dann auch per Kommandozeile oder
- Message gestartet werden können, so daß z.B. kurz vor dem
- Ausschalten der Rechners alle wichtigen (Quell-) Texte autom.
- gesichert werden.
- Aber das geht halt noch nicht.
-
-
- 2.2. Datei-Fenster
-
- Die Library von DiskList ist aus sog. 'Chunks' aufgebaut. Diese
- repräsentieren Disketten, Ordner, Files, Archive und was 's sonst
- noch so gibt.
- Jeder Chunk wird in einer Zeile angezeigt. Enthält er weitere
- Dateien, so kann er durch Einfachklicks auf/zugeklappt werden.
-
- (bla, bla,... daß so Anleitungen immer so lange sein müssen, ich
- versuch mich jetzt ehrlich mal auf wesentliche Dinge zu
- beschränken und das ganze Geblubber zwischendrin dann doch noch
- mal sein zu lassen...)
-
- Also KURZ (= ausprobieren):
-
- 2.2.1. Einfach Links-Klicks
-
- 'alleine': Ordner (etc.) auf/zu klappen
- mit Shift: selektieren
- + Control = jeweils auch den Inhalt bei Ordnern
- + Alternate = das Help-Popup erscheint
- (==> unbedingt mal ansehen!!)
-
- 2.2.2. Doppel-Links-Klick
-
- 'alleine': Chunk in einem neuen Fenster anzeigen.
- mit Shift: Datei von einem File-Viewer anzeigen lassen.
- mit Control: File-Info: Hier kann auch ein Kommentar eingegeben
- werden.
-
- 2.2.3. Dragging
-
- Selektierte Dateien können auf fremde Fenster gezogen werden.
-
-
- Seit Version 3.22 läßt sich das Button-Handling nun auch etwas
- konfigurieren (und zwar über DISKLIST.INF).
-
-
- 2.3. Fenster allgemein
-
- 2.3.1 Maus
-
- Rechtsklick im Fenster: Scrollen
- Rechtsklick im Rahmen: Sizen (GEM goes X11 :-)
- Shift+R-Klick: Sizen
- Linksklick im Rahmen: Moven
- Rechts+Links-Klick (Rahmen): auch Moven.
-
- das geht auch, wenn das Fenster im Hintergrund und DiskList aktiv
- (= das oberste Fenster gehört DiskList) ist.
-
- (Das war abr kurz - Wahnsinn!)
-
- 2.3.2. Tasten
-
- 'Help' - Das Help-Popup erscheint - da steht dann alles drin, was tut:
- ^I - Info über die Dateien im Fenster (alle oder selektierte)
- ^F - Dateien in dem Fenster suchen.
- ^E - Dateien exportieren (alle oder selektierte)
- ^S - Der Text des Fensters wird in ein File geschrieben.
- ^C - Der Text wird auf Clipboard geschrieben.
- ^P - Der Text wird gedruckt.
-
- Die Cursor-Tasten kann man auch benutzen:
-
- Umschalt-T. | Datei-Fenster | Dialog-Fenster
- ------------+---------------+------------------
- keine | Scrollen | (Laufwerk wählen)
- Shift | Seitenweise " | -
- Control | 'Sizen' | 'Moven'
- Shift+ | |
- Control | 'Moven' | 'Moven'
-
- Zu den Cursor-Tasten zählt auch "Clr/Home".
-
- Ach ja, die Fenster können mit "U"/"^U" geschlossen und mit
- "W"/"^W" gewechselt werden. Das Wechseln erfolgt (falls möglich)
- global, also auch mit fremden Fenstern.
-
-
- 3. Einlesen
-
- Mit 'Einlesen' werden neue Disketten (oder algemein: Drives) zu
- der Library hinzugefügt (oder ersetzt, falls die Diskette schon
- vorhanden war).
-
- Zur Unterscheidung der Disketten werden die Bytes 3 bis 12 des
- Boot-Sektors herangezogen, welche normalerweise die Bezeichnungen
- "Filler" für einen sechszeichigen (d.h. aus 6 (in Worten: sechs)
- Zeichen bestehenden) Disketten-Namen und "ID" für eine drei Bytes
- lange Kennung tragen.
- Außerdem wird nach dem Volume-Label gesucht. Diese ganzen
- Informationen werden nun angezeigt + der Benutzer bekommt die
- Gelegenheit, einen für ihn besser geeigneten Namen (z.B. die
- ersten 32 Zeichen der Beschriftung) einzugeben. Falls ein
- NeoDesk-Dateiname vorhanden war, so wird dieser voreingestellt.
- Ist die \DISKLIST.DAT im Wurzelverzeichnis vorhanden, so wird auch
- dort nach einem Namen gesucht (s.u.).
-
- War diese Diskette nun schon in der Library, so wird sie nun
- ersetzt, anderenfalls angefügt.
- Es kann Probleme geben, falls zwei Disketten die gleiche ID haben
- (z.B. meine Harddisk-Partitions). Dann sollte man am besten den
- Disketten/Laufwerken unterschiedliche Labels geben.
- War noch kein Label vorhanden, so kann ein neuer eingegeben
- werden, welcher auf die Diskette geschrieben wird. Die Diskette
- sollte nicht schreibgeschützt sein, da sonst gar nix geschrieben
- wird (werden kann).
-
-
- 4. Exportieren
-
- Es können alle bzw. alle selektieren Dateien exportiert werden:
- Das Format ist:
-
- "Filename", length, "Datum", "Zeit", "Pathname", "DiskettenName", "Label"
-
- Jede Datei belegt eine Zeile. Die Felder sind in >"<
- eingeschlossen (bis auf die Länge) und durch >,< getrennt.
- Als erste Zeile wird:
- file,length,date,time,path,diskname,disklabel
- ausgegeben, also die Feld-Namen. Dieses Format wird von vielen
- Datenbanken unterstützt und sollte daher ausreichen. Wer Probleme
- hat kann sich vertrauensvoll an mich wenden... (also ich dachte
- jetzt in 1. Linie an Probleme mit DiskList!)
-
-
- 5. Optionen
-
- Es gibt 'n schönen Optionen-Dialog mit vielen Schaltern:
-
- 5.1. Einlesen
-
- x "Archive einlesen" (read.Archives):
- Es kann halt (bei Disketten) etwas arg lange dauern, die
- Inhaltsverzeichnisse in Archiven herauszulesen, deshalb
- abschaltbar.
- x "Pfad in Archiven" (read.ArcPath):
- Bei ZOO, LHarc etc. können auch Pfadnamen gespeichert werden.
- Diese werden dann auch mit eingelesen. Entspricht also etwas der
- -r Option von LHarx (oder wie hieß die, -x vielleicht!???)
- x "Namen in Großbuchstaben" (read.toUpper):
- Dabei können Dateinamen beim Einlesen in Großbuchtaben umgewandelt
- werden. Könnte ja mal nötig sein (wenn man zB ein Archiv auf 'nem
- UNIX System angelegt hat oder so...)
- x "Namen/Label erzeugen" (read.generateNames):
- Besitzt die Diskette noch keinen Namen/Laben, so denkt sich
- DiskList einen selber aus!!
- Klasse, gell! Leider ist DiskList nicht ganz so kreativ: Es
- wird einfach die darunter angegebene Maske benutzt. Ein '#'
- oder '0'er werden durch Zahlen ersetzt, die bei Null anfangen
- und so gewählt werden, daß in der aktuellen Library dieser Name
- (bzw. Label) noch nicht auftaucht.
- Das gibt natürlich Probleme, wenn man verschiedene Libraries
- benutzt, weil: doof! (also, d.h. DiskList kann natürlich nicht
- wissen, daß der Name doch schon vergeben ist - gegen mehrere
- Libraries ist nix einzuwenden.)
- Vielleicht kann man irgendwann sich dann mal 'ne Start-Zahl
- aussuchen. Aktuelle Abhilfe: Für jede Library 'n andere Maske.
-
- 5.2. Suchen
-
- x "auch Ordner etc.": Beim Suchen wird nicht nur nach Files
- gesucht, sondern halt auch nach Ordnern, Archiven und was sonst
- noch 'n Namen hat. Nach Disketten wird trotzdem nicht gesucht
- (vielleicht auch nicht so sinnvoll.
- x "Gr/Kl ignorieren": Was bedeutet das denn nun wieder? Soll eine
- Abkürzung für "mache beim Suchen keine Unterscheidung zwischen
- Groß- und Kleinbuchstaben" sein. Das GEMDOS macht 's ja auch
- nicht!
-
- 5.3. Dialog-Fenster
-
- x "Nicht toppen": Das 'Main'- und das 'Options'-Fenster werden
- bei einem Links-Klick in den Arbeitsbereich nicht getoppt (also
- nach vorne gebracht) - Rechts-Klick toppt ja sowieso nicht!
- Stattdessen lösen die links-Klicks dan gleich die Funktionen
- aus. Das ist doch mal pfiffig! (Das gibt's auch ab AES 4.00 als
- Funktion. DiskList kann's auch ohne!)
- Wenn das Fenster dann doch getoppt werden soll, kann man immer
- noch in den Rand klicken.
-
- 5.4. Anzeigen
-
- x "auch Hidden": In den Datei-Fenster werden auch Hidden und
- System-Files angezeigt. Wirkt sich nur beim neuen Öffnen auf
- die Fenster aus.
-
- 5.5. Sichern + DISKLIST.INF
-
- Mit dem 'Sichern'-Button wird die Datei DISKLIST.INF im aktuellen
- Verzeichnis angelegt, darin stehen alle eingestellten Optionen als
- ASCII-Text.
- DiskList sucht beim Starten nach DISKLIST.INF (im akt. Verzeichnis)
- und übernimmt daraus die Voreinstellungen.
-
- Zusätzlich lassen sich über DISKLIST.INF auch noch Optionen
- verändern, die nicht im Dialog erscheinen (weil nicht sinnvoll):
-
- read.nameMask, read.labelMask:
- Die Masken, die im Optionen-Dialog (noch) nicht direkt geändert
- werden können.
- read.nameOffset:
- Mit dieser Nummer wird der erste Label erzeugt (falls nocht nicht
- vorhanden).
- read.autoLibSave:
- Nach dem Einlesen von Laufwerken kann die Library autom.
- abgespeichert werden (true) oder nicht (false).
-
- selectShift:
- Hiermit kann ausgewählt werden, wie Dateien im Dateien-Fenster
- selektiert werden können (ob Shift gedrückt werden muß oder ob das
- nicht nötig sein soll).
-
- showMenuBar:
- Gibt an, ob bei einem Multi-Tasking-System die Menüzeile
- angemeldet werden soll, da die dann (eigentlich) überflüssig ist +
- ja auch nicht benötigt wird.
-
-
- 6. Der Viewer
-
- Ist ein Viewer installiert, so kann man sich mit dessen Hilfe Dateien
- ansehen.
- Das Vorhandensein eines Viewers wird über das View-Protokoll
- festgestellt (s. view.txt)
- Der ausgewählte Viewer bekommt dann eine VA_START-Message, ohne
- vorher zu prüfen, ob er die nun auch wirklich versteht... Wenn das
- Probleme gibt, werd ich's Ändern!
-
-
- A. Bekannte/behobene Fehler
-
- Es gibt noch einige Kleinigkeiten, die mir bekannt und noch nicht behoben
- sind. Diese haben bei mir aber noch nie zu einem Absturz oder Daten-Verlust
- geführt, sondern sich eher einige Unstimmigkeiten bzw. einfach nur un-
- praktisch.
-
- In allen früheren Versionen von DiskList war ein wind_update() zu
- viel drin! Ist mir überhaupt nicht klar, warum überhaupt irgendwas
- funktioniert hat.
-
- Das Einlesen von ZIP-Archiven ist noch nicht intensiv getestet; wenn
- es Probleme gibt (= Archive, die nicht korrekt eingelesen werden),
- sendet mir bitte diese, dann kann icht das (hoffentlich) verbessern.
- ZIP-Archive über mehrere Disketten werden NICHT unterstützt.
-
-
- B. Diverses:
-
- DiskList müßte mit allen Auflösungen + Konfigurationen
- zurechtkommen, so weit ich das Testen konnte, geht das auch -
- garantieren kann ich natürlich für nichts.
-
- Es läuft zumindest mit allen von mir erreichbaren TOS-Versionen
- (d.h. 1.02, 1.04, 2.06). Soweit ich weiß, benutzte ich auch nur
- 'offizielle' Funktionen.
- Mit MiNT gibt's noch einige Probleme. Vor allem konnte ich die
- Memory Protection nicht testen (snüff!).
- Mit Mag!X verträgt sich DiskList einwandfrei!
-
- Über Anregungen (und Fehler-Reports :-) freue ich mich jedenfalls immer.
-
- Benutzer von Let 'em Fly! von Oliver Scheel kommen in den Genuß
- aller dadurch vorhandenen Features, also Tastatur-Bedienung +
- 'Soft-Flying' + 'Undo' als Abbruch-Taste. Außerdem habe ich mir
- seinen Rat zu Herzen genommen + rufe vor jedem Neuzeichnen des
- einzigen nicht-verschiebbaren Dialogs (ratet mal, welcher das
- ist...) form_center neu auf, damit Let 'em Fly! diesen auch bei
- Bigscreen etc. in den angezeigten Bildschirmbereich befördern
- kann. Testen konnte ich das allerdings nicht.
-
-
- Für die, die es interessiert, wie DiskList die Daten ablegt, oder alle,
- die die Librarys ggf. selber benutzen wollen, können mich gerne über das
- Library-Format befragen.
- Es würde die Anleitung nur noch länger machen + wer weiß ob 's
- überhaupt jemanden interessiert?
-
- An dieser Stelle möchte ich noch allem Programmierern ans Herz
- legen, AV-, XAcc-, View- und D&D-Protokoll zu unterstützen,
- zumindest die Basis-Messages sind sehr einfach zu implementieren!!!
-
-
- So, ich denke das ist mehr als genug... (bla, bla, bla, ...)
- viel Spaß wünscht Euch - mögt ihr alle Eure Disketten finden!
-
- Peter
-
-